<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">

<html>
<head>
  <meta name="generator" content=
  "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">

  <title>Privoxy 3.0.19 User Manual</title>
  <meta name="GENERATOR" content=
  "Modular DocBook HTML Stylesheet Version 1.79">
  <link rel="NEXT" title="Introduction" href="introduction.html">
  <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  <link rel="STYLESHEET" type="text/css" href="p_doc.css">
  <style type="text/css">
body {
  background-color: #EEEEEE;
  color: #000000;
  }
  :link { color: #0000FF }
  :visited { color: #840084 }
  :active { color: #0000FF }
  hr.c2 {text-align: left}
  dt.c1 {font-weight: bold}
  </style>
</head>

<body class="ARTICLE">
  <div class="ARTICLE">
    <div class="TITLEPAGE">
      <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.19 User
      Manual</a></h1>

      <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> &copy;
      2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy
      Developers</a></sub><br></p>

      <p class="PUBDATE">$Id: user-manual.sgml,v 2.143 2011/11/20 17:16:36
      fabiankeil Exp $<br></p>

      <div class="ABSTRACT">
        <a name="AEN9" id="AEN9"></a>

        <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users
        information on how to install, configure and use <a href=
        "http://www.privoxy.org/" target="_top">Privoxy</a>.</p>

        <p>Privoxy is a non-caching web proxy with advanced filtering
        capabilities for enhancing privacy, modifying web page data and HTTP
        headers, controlling access, and removing ads and other obnoxious
        Internet junk. Privoxy has a flexible configuration and can be
        customized to suit individual needs and tastes. It has application
        for both stand-alone systems and multi-user networks.</p>

        <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>

        <p>Privoxy is an associated project of Software in the Public
        Interest (SPI).</p>

        <p>Helping hands and donations are welcome:</p>

        <ul>
          <li>
            <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE"
            target=
            "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
          </li>

          <li>
            <p><a href="http://www.privoxy.org/faq/general.html#DONATE"
            target=
            "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p>
          </li>
        </ul>

        <p>You can find the latest version of the <i class=
        "CITETITLE">Privoxy User Manual</i> at <a href=
        "http://www.privoxy.org/user-manual/" target=
        "_top">http://www.privoxy.org/user-manual/</a>. Please see the
        <a href="contact.html">Contact section</a> on how to contact the
        developers.</p>
      </div>
      <hr>
    </div>

    <div class="TOC">
      <dl>
        <dt class="c1">Table of Contents</dt>

        <dt>1. <a href="introduction.html">Introduction</a></dt>

        <dd>
          <dl>
            <dt>1.1. <a href="introduction.html#FEATURES">Features</a></dt>
          </dl>
        </dd>

        <dt>2. <a href="installation.html">Installation</a></dt>

        <dd>
          <dl>
            <dt>2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary
            Packages</a></dt>

            <dd>
              <dl>
                <dt>2.1.1. <a href=
                "installation.html#INSTALLATION-PACK-RPM">Red Hat and Fedora
                RPMs</a></dt>

                <dt>2.1.2. <a href=
                "installation.html#INSTALLATION-DEB">Debian and
                Ubuntu</a></dt>

                <dt>2.1.3. <a href=
                "installation.html#INSTALLATION-PACK-WIN">Windows</a></dt>

                <dt>2.1.4. <a href=
                "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a></dt>

                <dt>2.1.5. <a href=
                "installation.html#INSTALLATION-OS2">OS/2</a></dt>

                <dt>2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac
                OS X</a></dt>

                <dt>2.1.7. <a href=
                "installation.html#INSTALLATION-AMIGA">AmigaOS</a></dt>

                <dt>2.1.8. <a href=
                "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>

                <dt>2.1.9. <a href=
                "installation.html#INSTALLATTION-GENTOO">Gentoo</a></dt>
              </dl>
            </dd>

            <dt>2.2. <a href="installation.html#INSTALLATION-SOURCE">Building
            from Source</a></dt>

            <dt>2.3. <a href=
            "installation.html#INSTALLATION-KEEPUPDATED">Keeping your
            Installation Up-to-Date</a></dt>
          </dl>
        </dd>

        <dt>3. <a href="whatsnew.html">What's New in this Release</a></dt>

        <dd>
          <dl>
            <dt>3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to
            Upgraders</a></dt>
          </dl>
        </dd>

        <dt>4. <a href="quickstart.html">Quickstart to Using Privoxy</a></dt>

        <dd>
          <dl>
            <dt>4.1. <a href=
            "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad
            Blocking</a></dt>
          </dl>
        </dd>

        <dt>5. <a href="startup.html">Starting Privoxy</a></dt>

        <dd>
          <dl>
            <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and
            Fedora</a></dt>

            <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt>

            <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>

            <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
            FreeBSD, HP-UX and others</a></dt>

            <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>

            <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>

            <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt>

            <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt>

            <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line
            Options</a></dt>
          </dl>
        </dd>

        <dt>6. <a href="configuration.html">Privoxy Configuration</a></dt>

        <dd>
          <dl>
            <dt>6.1. <a href="configuration.html#AEN1090">Controlling Privoxy
            with Your Web Browser</a></dt>

            <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
            Files Overview</a></dt>
          </dl>
        </dd>

        <dt>7. <a href="config.html">The Main Configuration File</a></dt>

        <dd>
          <dl>
            <dt>7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up
            Documentation</a></dt>

            <dd>
              <dl>
                <dt>7.1.1. <a href=
                "config.html#USER-MANUAL">user-manual</a></dt>

                <dt>7.1.2. <a href=
                "config.html#TRUST-INFO-URL">trust-info-url</a></dt>

                <dt>7.1.3. <a href=
                "config.html#ADMIN-ADDRESS">admin-address</a></dt>

                <dt>7.1.4. <a href=
                "config.html#PROXY-INFO-URL">proxy-info-url</a></dt>
              </dl>
            </dd>

            <dt>7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log
            File Locations</a></dt>

            <dd>
              <dl>
                <dt>7.2.1. <a href="config.html#CONFDIR">confdir</a></dt>

                <dt>7.2.2. <a href="config.html#TEMPLDIR">templdir</a></dt>

                <dt>7.2.3. <a href="config.html#LOGDIR">logdir</a></dt>

                <dt>7.2.4. <a href=
                "config.html#ACTIONSFILE">actionsfile</a></dt>

                <dt>7.2.5. <a href=
                "config.html#FILTERFILE">filterfile</a></dt>

                <dt>7.2.6. <a href="config.html#LOGFILE">logfile</a></dt>

                <dt>7.2.7. <a href="config.html#TRUSTFILE">trustfile</a></dt>
              </dl>
            </dd>

            <dt>7.3. <a href="config.html#DEBUGGING">Debugging</a></dt>

            <dd>
              <dl>
                <dt>7.3.1. <a href="config.html#DEBUG">debug</a></dt>

                <dt>7.3.2. <a href=
                "config.html#SINGLE-THREADED">single-threaded</a></dt>

                <dt>7.3.3. <a href="config.html#HOSTNAME">hostname</a></dt>
              </dl>
            </dd>

            <dt>7.4. <a href="config.html#ACCESS-CONTROL">Access Control and
            Security</a></dt>

            <dd>
              <dl>
                <dt>7.4.1. <a href=
                "config.html#LISTEN-ADDRESS">listen-address</a></dt>

                <dt>7.4.2. <a href="config.html#TOGGLE">toggle</a></dt>

                <dt>7.4.3. <a href=
                "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a></dt>

                <dt>7.4.4. <a href=
                "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a></dt>

                <dt>7.4.5. <a href=
                "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a></dt>

                <dt>7.4.6. <a href=
                "config.html#ENFORCE-BLOCKS">enforce-blocks</a></dt>

                <dt>7.4.7. <a href="config.html#ACLS">ACLs: permit-access and
                deny-access</a></dt>

                <dt>7.4.8. <a href=
                "config.html#BUFFER-LIMIT">buffer-limit</a></dt>
              </dl>
            </dd>

            <dt>7.5. <a href="config.html#FORWARDING">Forwarding</a></dt>

            <dd>
              <dl>
                <dt>7.5.1. <a href="config.html#FORWARD">forward</a></dt>

                <dt>7.5.2. <a href="config.html#SOCKS">forward-socks4,
                forward-socks4a and forward-socks5</a></dt>

                <dt>7.5.3. <a href=
                "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
                Forwarding Examples</a></dt>

                <dt>7.5.4. <a href=
                "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a></dt>
              </dl>
            </dd>

            <dt>7.6. <a href="config.html#MISC">Miscellaneous</a></dt>

            <dd>
              <dl>
                <dt>7.6.1. <a href=
                "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a></dt>

                <dt>7.6.2. <a href=
                "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a></dt>

                <dt>7.6.3. <a href=
                "config.html#SPLIT-LARGE-FORMS">split-large-forms</a></dt>

                <dt>7.6.4. <a href=
                "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a></dt>

                <dt>7.6.5. <a href=
                "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt>

                <dt>7.6.6. <a href=
                "config.html#CONNECTION-SHARING">connection-sharing</a></dt>

                <dt>7.6.7. <a href=
                "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt>

                <dt>7.6.8. <a href=
                "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt>

                <dt>7.6.9. <a href=
                "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt>

                <dt>7.6.10. <a href=
                "config.html#ENABLE-COMPRESSION">enable-compression</a></dt>

                <dt>7.6.11. <a href=
                "config.html#COMPRESSION-LEVEL">compression-level</a></dt>
              </dl>
            </dd>

            <dt>7.7. <a href="config.html#WINDOWS-GUI">Windows GUI
            Options</a></dt>
          </dl>
        </dd>

        <dt>8. <a href="actions-file.html">Actions Files</a></dt>

        <dd>
          <dl>
            <dt>8.1. <a href="actions-file.html#AEN2879">Finding the Right
            Mix</a></dt>

            <dt>8.2. <a href="actions-file.html#AEN2886">How to Edit</a></dt>

            <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
            are Applied to Requests</a></dt>

            <dt>8.4. <a href=
            "actions-file.html#AF-PATTERNS">Patterns</a></dt>

            <dd>
              <dl>
                <dt>8.4.1. <a href="actions-file.html#AEN2998">The Domain
                Pattern</a></dt>

                <dt>8.4.2. <a href="actions-file.html#AEN3074">The Path
                Pattern</a></dt>

                <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
                Pattern</a></dt>
              </dl>
            </dd>

            <dt>8.5. <a href="actions-file.html#ACTIONS">Actions</a></dt>

            <dd>
              <dl>
                <dt>8.5.1. <a href=
                "actions-file.html#ADD-HEADER">add-header</a></dt>

                <dt>8.5.2. <a href="actions-file.html#BLOCK">block</a></dt>

                <dt>8.5.3. <a href=
                "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a></dt>

                <dt>8.5.4. <a href=
                "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></dt>

                <dt>8.5.5. <a href=
                "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt>

                <dt>8.5.6. <a href=
                "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt>

                <dt>8.5.7. <a href=
                "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt>

                <dt>8.5.8. <a href=
                "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt>

                <dt>8.5.9. <a href=
                "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt>

                <dt>8.5.10. <a href=
                "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt>

                <dt>8.5.11. <a href=
                "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt>

                <dt>8.5.12. <a href=
                "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt>

                <dt>8.5.13. <a href=
                "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt>

                <dt>8.5.14. <a href=
                "actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt>

                <dt>8.5.15. <a href=
                "actions-file.html#FILTER">filter</a></dt>

                <dt>8.5.16. <a href=
                "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt>

                <dt>8.5.17. <a href=
                "actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt>

                <dt>8.5.18. <a href=
                "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt>

                <dt>8.5.19. <a href=
                "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt>

                <dt>8.5.20. <a href=
                "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt>

                <dt>8.5.21. <a href=
                "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt>

                <dt>8.5.22. <a href=
                "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt>

                <dt>8.5.23. <a href=
                "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt>

                <dt>8.5.24. <a href=
                "actions-file.html#HIDE-REFERRER">hide-referrer</a></dt>

                <dt>8.5.25. <a href=
                "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt>

                <dt>8.5.26. <a href=
                "actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>

                <dt>8.5.27. <a href=
                "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>

                <dt>8.5.28. <a href=
                "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>

                <dt>8.5.29. <a href=
                "actions-file.html#REDIRECT">redirect</a></dt>

                <dt>8.5.30. <a href=
                "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>

                <dt>8.5.31. <a href=
                "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>

                <dt>8.5.32. <a href=
                "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>

                <dt>8.5.33. <a href=
                "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>

                <dt>8.5.34. <a href=
                "actions-file.html#AEN4706">Summary</a></dt>
              </dl>
            </dd>

            <dt>8.6. <a href="actions-file.html#ALIASES">Aliases</a></dt>

            <dt>8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files
            Tutorial</a></dt>

            <dd>
              <dl>
                <dt>8.7.1. <a href=
                "actions-file.html#AEN4770">match-all.action</a></dt>

                <dt>8.7.2. <a href=
                "actions-file.html#AEN4792">default.action</a></dt>

                <dt>8.7.3. <a href=
                "actions-file.html#AEN4905">user.action</a></dt>
              </dl>
            </dd>
          </dl>
        </dd>

        <dt>9. <a href="filter-file.html">Filter Files</a></dt>

        <dd>
          <dl>
            <dt>9.1. <a href="filter-file.html#AEN5060">Filter File
            Tutorial</a></dt>

            <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
            Pre-defined Filters</a></dt>
          </dl>
        </dd>

        <dt>10. <a href="templates.html">Privoxy's Template Files</a></dt>

        <dt>11. <a href="contact.html">Contacting the Developers, Bug
        Reporting and Feature Requests</a></dt>

        <dd>
          <dl>
            <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get
            Support</a></dt>

            <dt>11.2. <a href="contact.html#REPORTING">Reporting
            Problems</a></dt>

            <dd>
              <dl>
                <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
                or Other Configuration Problems</a></dt>

                <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
                Bugs</a></dt>
              </dl>
            </dd>

            <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New
            Features</a></dt>

            <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing
            Lists</a></dt>
          </dl>
        </dd>

        <dt>12. <a href="copyright.html">Privoxy Copyright, License and
        History</a></dt>

        <dd>
          <dl>
            <dt>12.1. <a href="copyright.html#AEN5542">License</a></dt>

            <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>

            <dt>12.3. <a href="copyright.html#AUTHORS">Authors</a></dt>
          </dl>
        </dd>

        <dt>13. <a href="seealso.html">See Also</a></dt>

        <dt>14. <a href="appendix.html">Appendix</a></dt>

        <dd>
          <dl>
            <dt>14.1. <a href="appendix.html#REGEX">Regular
            Expressions</a></dt>

            <dt>14.2. <a href="appendix.html#AEN5795">Privoxy's Internal
            Pages</a></dt>

            <dd>
              <dl>
                <dt>14.2.1. <a href=
                "appendix.html#BOOKMARKLETS">Bookmarklets</a></dt>
              </dl>
            </dd>

            <dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>

            <dt>14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting:
            Anatomy of an Action</a></dt>
          </dl>
        </dd>
      </dl>
    </div>
  </div>

  <div class="NAVFOOTER">
    <hr class="c2" width="100%">

    <table summary="Footer navigation table" width="100%" border="0"
    cellpadding="0" cellspacing="0">
      <tr>
        <td width="33%" align="left" valign="top">&nbsp;</td>

        <td width="34%" align="center" valign="top">&nbsp;</td>

        <td width="33%" align="right" valign="top"><a href=
        "introduction.html" accesskey="N">Next</a></td>
      </tr>

      <tr>
        <td width="33%" align="left" valign="top">&nbsp;</td>

        <td width="34%" align="center" valign="top">&nbsp;</td>

        <td width="33%" align="right" valign="top">Introduction</td>
      </tr>
    </table>
  </div>
</body>
</html>
